*************************************************************************
*									*
*     	    SPACE DEMENTIA beta v0.8 for the TI89/TI92+/V200		*
*			  by Thibaut Chevalier				*
*		moitib_calliope@hotmail.com or moitib@fr.st		*
*			http://moitib.free.fr/				*
*									*
*			Editor by David Coz				*
*			coz.hubert@infonie.fr				*
*									*
*			copyright 23/02/2003				*
*									*
*************************************************************************


*************************************************************************
* 1 / Introduction							*
*************************************************************************

 Space Dementia is a 3D wireframe game running with a small 3D engine 
made by myself with the help of David Coz's tutorials. This version is
a beta version, which means that all the things planed are not finished. 
However, the game is quite playable and fun to play.

If you have any problems with this game: it doesn't run, or if it crashes 
:( please report the problem to me (with the hardware version and the AMS 
version) at moitib_calliope@hotmail.com or moitib@fr.st.


*************************************************************************
* 2 / Installation							*
*************************************************************************

 Send dementia.--y and dementia.--z to your calculator.
The game is compressed so there are two files on the calc :
 - dementia (ASM)
 - demcode (PPG)
You can play the game with both files archived.
If a message "Out of memory" is displayed, that means you have not enough
free RAM on your calc. Archive or delete some files and try again.
If the program stops during its execution with the same message, do the
same.

When running the game for the first time, a file countaining the 
highscores and the preferences will be created on the "current folder" 
(generally MAIN). Its name is :
 - demhsc (dem)
If you move or delete this file, a new one will be created in the "current
folder" and the highscores will have been reset.
If you unarchive this file, the program will archive it.

This program is nostub, i.e. you don't need any shell or kernel to run it !
To run the game, just type dementia() and press enter. Enjoy !

NB : 
 - The game may be slower on Hardware 1, because of the processor speed.
I have not rescricted the speed on the HW2 version to have the same on
the 2 models, because it would be stupid for the HW2 users...
 - The game has not been specially tested on the V200, but it should work
exactly as on the 92+.


*************************************************************************
* 3 / Gaming modes							*
*************************************************************************

There are now 2 game modes : 
TRAINING and ASTEROIDS FIELD.

A/ TRAINING :
Your have to fly through the rings with your ships.
There are 20 rings to pass across to finish the training.
There are no ennemies, no weapons...
Your mark is shown on the top-left corner of the screen.

B/ ASTEROIDS FIELD :
In this mode you have to avoid the asteroids  while trying to
destroy a maximum of them with your weapons :

Weapons :
 - Laser Cannons (2nd)
   You can fire continuously (keeping the key down).
   You need to hit 3 times an asteroid to destroy it with this weapon.
 - Remote Missile (diamond)
   You can lauch a special missile that you command like a ship. The
   camera locks on it and you must direct it on an asteroid. If not, you 
   lose its control after a certain amount of time. The distance left 
   is represented by a bar at the top of the screen.
   Your stock is limited : it is shown on the down-left corner of the
   screen. You gain one missile each time you pass across 5 asteroids.

Asteroids :
There are two kinds of "ennemies" to destroy :
 - Asteroids
 - kamikazes droids which fly to your ship

Score :
Your final score depends on the time you've been flying (the number in the
top left corner), the size of your ship (the flight time is multiplied by 
a coeficient) and the number of asteroids you have destroyed. (100 per 
asteroid destroyed). There's a multiplicative bonus if you have choosen 
the 'spiral mode' for the asteroids trajectories.

Highscores :
I you have an highscore, the name you have given in the option menu is
saved in the hall of fame with your score.

C/ Features common to the 2 gaming modes :

Camera :
There are two camera modes :
 - Fixed camera
   The camera is fixed in the space and you see the ship moving in the 
   vertical plane.
 - Ship-locked camera
   The camera is locked behind the ship.
   In this mode, there is a little lock on the down right corner.
The starting mode is the one you have choosen in the options screen.
You can switch during the game with F1/F2.


*************************************************************************
* 4 / Options - Preferences						* 
*************************************************************************

The options you choose in the 'options' menu are saved from one execution
to another in the 'demhsc' file.

Player Name :
Before starting the game, you have to enter your name, and it will be
saved automatically in the hall of fame if you enter it.
You can enter or change your name from the 'options' menus or from the
'play' menu.

Ships controls :
There are two controls mode, and each one has its own highscore table.

 - Arcade :
   The ship movement are directly linked to its angles (horizontaly and
   vertically). This mode is the easier to play.
 - Simulation :
   In this mode the controls are closer to the reality.
   the [left] and [right] keys turn your ship, but it doesn't move. You
   can make a complete turn and fly upside-down if you want :)
   To move the ship, you have to use the [up] and [down] keys.
   If your ship is horizontal, he will only go up or down.
   If it makes a 90 angle with the horizontale plane, it will only move
   to the left of to the rigth.
   If its angle is between theses values, the movements will be mixed.

   Hmm not very easy to describe. Try it yourself !

Asteroids' Trajectory :
Now you can have 2 movements for the asteroids (in the Asteroids field 
mode).
Their trajectories can be :
 - Lines
 - Helicoids
   In this mode the distance covered is multiplied by 2 in the score.
   You can change the speed of the rotation with [+] and [-], but it
   will handicap you (much more difficult to survive !). I have just
   implemented this function for fun !

Default camera mode :
Choose the one you prefer. At the beggining of a game, this mode will
be applied automaticaly.


*************************************************************************
* 5 / Ship editing							* 
*************************************************************************

Now you can create on your calc you own ships and play with them in the
game !!!
Do to that, you need the version 0.95 of Edit3D by David Coz which is
(or will be) available on my website.
To create your ships files, refer to the text file "ShipEdit Readme".

To play with an external ship, simply place the file ANYWHERE on your calc
and the ship will AUTOMATICALLY be added at the end of the list in the
'ship selection screen'. Select it like you would do for another ship,
and enjoy.

If you think have created a good ship and you would like to distribute it,
you can email it to me and i will put it on my website.

I hope this feature will help the game to survive...


*************************************************************************
* 6 / Keys summary							* 
*************************************************************************

TI-89 :
-------

@ menu screens :
 - Up/Down : move the cursor 
 - Enter : do what is written in the status bar
 - Esc : return to the previous menu (Quit in the home screen)

@ the ship selection screen
 - Left/Right : change of ship
 - Up/Down : rotate the ship
 - Enter : begin the game with this ship
 - Esc : Back to the 'play' menu

@ the game screen :
 - Left/Right : Turn the ship around the z axis
 - Left AND Rigth : Stabilize the ship on this axe if its angle is small
 - Up/down : Turn the ship around the x axis
 - Up AND Down : Stabilize the ship on this axe if its angle is small
 - Esc/Apps : move away/closer
 - 2nd : fire laser cannons (on the same axis than the ship)
 - diammond : launch a remote missile
 - shift : pause the game (a pause screen with a menu appears)
 - Clear : Autodestruction

N.B. : you can turn off the calculator from the pause menu.

@ the hall of fame screen :
 - Left/Right : See the table of the other gaming mode
 - Esc/Enter : Return to the main menu

@ other screens :
   Press [Enter] or [Esc] to continue.



TI-92+/V200:
------------

@ menu screens :
 - Up/Down : Move the cursor 
 - Enter (next to the cursor pad) : Do what is written in the status bar
 - Esc : Return to the previous menu (Quit in the home screen)

@ the ship selection screen
 - Left/Right : Change of ship
 - Up/Down : Rotate the ship
 - Enter : Begin the game with this ship
 - Esc : Back to the 'play' menu

@ the game screen :
 - Left/Right : Turn the ship around the z axis
 - Up/down : Turn the ship around the x axis
 - F2/F6 : move away/closer
 - F1 : fire laser cannons (on the same axis than the ship)
 - F5 : Launch a remote missile (on the same axis than the ship)
 - F3/F7 : Select camera mode
 - Apps : pause the game (a pause screen appears)
 - Esc : Autodestruction

NB : you can turn off the calculator from the pause menu.

@ the hall of fame screen :
 - Left/Right : See the table of the other gaming mode
 - Esc/Enter : Return to the main menu

@ other screens :
   Press [Enter] or [Esc] to continue.


*************************************************************************
* 7 / Known bugs							*
*************************************************************************

 - The first time you enter your name, the first key you press makes the
TI-OS bar appear, and then the second press prints the first letter.


*************************************************************************
* 8 / Future versions							*
*************************************************************************

  I don't think there will be future versions before next September,
because of my studies. I have no time enough to continue the project this
year.

However, possible things to do are :
 - A beggining and a end to the game (levels).
 - A "boss" ship to destroy at the end of the level
 - Ennemies during the game
 - a story-line


*************************************************************************
* 9 / history								*
*************************************************************************

23/02/2003 : v0.8
  - training mode
  - droids added in the Asteroids field mode
  - options / preferences
	-> Controls mode (Arcade & Simulation)
	-> asteroids' trajectory
  - External ships !!
  - Menus
  - Design

31/10/2002 : v0.71
 bug fixes 
  - score when the game was stopped in remote missile mode
  - important bug which lead to crash if there was not enough free memory

24/10/2002 : v0.7
 Second beta version
  - added new ships
  - continuous fire
  - remote missile
  - camera modes
  - highscores

04/09/2002 : v0.5
 First released version (beta)
  - game engine done, explosions, a small score feature


*************************************************************************
* 10 / Thanks to...							*
*************************************************************************

- The TIGCC team for having made possible to program in C for the TI-89
- David Coz for his 3D tutorials (available on http://www.ticalc.org/),
 his help and his wonderful work with the editor.
- The people who have encouraged me after seeing the first versions...
- The testers (especially Henry Barrow for the ship examples)
- People who helped me on the french forum : yaronet.com

		
*************************************************************************
* 11 / Disclaimer							*
*************************************************************************

This program may be distributed for non-commercial use only.

The author makes no representations or warranties about the suitability
of the software and/or the data files, either express or implied.
The author shall not be liable for any damages suffered as a result of using
or distributing this software and/or data files.

You are free to re-use any part of the sourcecode in your products as long as
you give credits to me.

If you have found this program cool, or if you have comments, bug reports
or anything email me at moitib_calliope@hotmail.com or moitib@fr.st
Receiving mails encourages me. Thanx !!

Have fun with Space Dementia !! 
